home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / pascal / ghostbbs.zip / GSBBS214.TXT < prev    next >
Text File  |  1986-08-05  |  12KB  |  295 lines
  1.                 Introduction
  2.  
  3.     This BBS system is written in Borland's Turbo Pascal version 
  4. 3.0 and is based on Bob Maxwell's TurboBBS program written for the
  5. Kaypro.  Many of the routines have been revised or rewritten for the
  6. IBM or compatibles.
  7.  
  8.     This version of Ghost Ship BBS (GSBBS) has been up and running
  9. as of AUgust 6th, 1986.  It should operate almost 24 hrs a day at 300/
  10. 1200 baud.  The phone number is 203-655-0152.  The current BBS at that
  11. number was started by obtaining files form the Original Ghost Ship BBS,
  12. the Ghost Ship East, who's number (now in Boston) is unknown.  Any 
  13. questions, or ideas for new mods are welcome, give the BBS a call and
  14. I'll generally be around to <C>hat.
  15.  
  16.     The program will run on a Compaq Deskpro or Portable (with 
  17. either 8086 or Nec V30) under MS-DOS ver 2.1, 2.11 or a PC's limited 
  18. Turbo-PC running PC-DOS ver 3.1, both with Hayes Smartmodem (300/1200)
  19. and on 256 or 640k com1.  It canm be assumed that if it will run on
  20. these machines it will also run on stock IBM PCs with a Hayes or
  21. compatible modem.
  22.  
  23.     The GSBBS is advantageous over the RBBS in many ways.  Among
  24. them is the fact that it is faster, and smaller.  Also Pascal is much
  25. easier to read and add mods to than piles of BASIC code.  As far as 
  26. size, as I mentioned earlier GSBBS is only 64k  while RBBS is 212k in
  27. BASIC form and it needs a 100K config program.
  28.  
  29.     I have added many mods to the program (thus ver 2.14 rather 
  30. than 2.1).  Also there is no warning about it being shareware or 
  31. copy-protected, so it CAN be distributed in modified form.
  32.     * Minimal PASCAL knowledge needed to run a GSBBS
  33.     * 5 primary access levels with 8 secondary ones
  34.     * Stand alone E-mail system
  35.     * As many as 255 separate sub-boards
  36.     * Up to 255 separate files sections
  37.     * Less than 10% waste in message storage
  38.     * Interrupt driven buffered input
  39.     * XMODEM protocol with CRC
  40.     * ASCII upload and download capabilities (of course)
  41.     * Complete remote SYSOP maintenance
  42.     * Word Wrap for messages
  43.     * Command stacking
  44.     * User message displayed before prompt
  45.     * NEW feedback
  46.     * Online verification
  47.     * Toggle CHAT availability inside of SYSOP hours
  48.         * MUCH more...
  49.  
  50. (The last five functions mentioned are my mods and will be explained 
  51. in detail later in the docs)
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. The following files are used to run GSBBS
  65.  
  66. System files (Main default drive and directory)
  67. BB1.PAS     Compiles into BB1.COM
  68. BB2.PAS        Chain program compiled when BB1 compiled
  69. BB3.PAS        Chain program compiled when BB1 compiled
  70.  
  71. Other files (Main default rive and directory)
  72. COMPMESS.PAS    Used to clean and compress message bases
  73. COMPMESS.BAT       Use in conjunction with COMPMESS.PAS
  74. SORT1.PAS    Used with DOS' SORT.EXE (updates user file)
  75. MAILCLR.PAS    Cleans up mail title file
  76. ERR.PAS        Tkae a snapshot of screen when an error occurs
  77. CONVTIDS.PAS    ***
  78. CONFIG.CNF    COnfiguration file for system
  79. S1.BAT        Batch file for system start-up
  80. GSBBS214.DOC    This thing you are reading now.
  81.  
  82. Help files and some CONFIG (Main drive, BBSINFO directory)
  83.  
  84. FILES.CNF     Configures file sections
  85. TITLES.CNF     Configures sub-boards
  86.  
  87. APPYING.TXT
  88. BBSHELP.TXT
  89. BBSLIST.TXT
  90. BULLETIN.TXT
  91. EDITMENU.TXT
  92. FILEHLP.TXT    Various help and info files
  93. FILEMENU.TXT
  94. MAINMENU.TXT
  95. READMENU.TXT
  96. SYSINFO.TXT
  97. WELCOME.TXT
  98.  
  99. Created by system
  100. USER.TXT    Created when SORT1.COM run.  Shows user listing
  101. TIMELOG.BBS     Available to users, baud rate, etc.
  102. USERLOG.TXT    More informative ver of TIMELOG.  Open to SYSOP only
  103. DIR.BBS        Shows directory of files
  104. TITLEnn.BBS    Keept in messag subdirectory, contains all msg headers
  105. MESSnn.BBS    Pointer for each msg header kept here. (also in msg 
  106.          subdirectory)
  107.  
  108. Created with EDLIN
  109. IDS.BBS        User stats
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                 GETTING STARTED
  127.     
  128.     First, make sure all of the files mentioned (other than those
  129. that are created later) are in their proper places.  When that is done,
  130. create the file IDS.BBS with edlin.  Do not enter anything just create
  131. it and exit without putting any information in it.  This is 
  132. necessary as the program will look for this file and if it is not 
  133. present an I/O error will occur.
  134.     Next, edit the file CONFIG.CNF (once again I used Edlin).
  135. List the file.  As you can see it only has five lines  The first is
  136. the number of calls your BBS has had, reset it to 0 for a new BBS,
  137. or enter the number of calls your old BBS has gotten.  The second 
  138. line shows the SYSOP name.  It MUST be entered in caps.  The third 
  139. line is what kind of monitor you have.  It is suggested you keep 
  140. COLOR.  In COLOR, a border (blue if color monitor, green if mono)
  141. appears when a user is logged on, in MONO nothing alerts the sysop of a
  142. user logged on.  The fourth line is how many sub-boards you have, this
  143. number must match exactly with the number of sub-boards defined in the
  144. file TITLES.CNF.  The fourth number is the number of file sections,
  145. once again this must match exactly with the number of file sections 
  146. specified in FILES.CNF.  The number of message or file sections cannot
  147. exede 20 unless you change the variables maxfilesects and maxsects in
  148. the program.  You need not change the variable for less than 20.
  149.  
  150. Editing FILES.CNF and TITLES.CNF
  151.  
  152.     These files define how many sections you are going to have
  153. for files and message bases, where they will be kept and what access
  154. is needed to gain access.  Use EDLIN to edit the file TITLES.CNF.
  155. Listing it you can see the first 6 lines are...
  156.  
  157. 1  Main Deck
  158. msg\
  159. 1 0
  160. 2  Joke Board
  161. msg\
  162. 1 0
  163.  
  164.      The first and fourth lines show the number and name of the sub.
  165. The number cannot excede the number specified in CONFIG.CNF.  The 2nd
  166. and 5th lines show where the files for that board are kept.  This says
  167. subdirectory MSG on the default drive.  My it could easily be changed
  168. to be more specific (B:\JOKES\ or B:\MAIN\) etc.  The 3rd and 6th lines
  169. show what access is needed to get into the subs.  The first number is
  170. the primary access.  It can be from 1-5.  The second is the secondary
  171. access, read the section on access (below) before entering the access
  172. levels needed.
  173.     FILES.CNF looks exactly like TITLES.CNF and is done in the
  174. same way.  Once again the number of filesections defined must match
  175. the number stated in CONFIG.CNF exactly.
  176.  
  177. ACCESS LEVELS
  178.     The primary access levels are easy.  There are 6 of them, 0 
  179. to 5.  THe meaning is as follows...
  180. 0 = twit (no time allowed on system, locked out)
  181. 1 = newuser (cannot post or upload)
  182. 2 = reguser (can do all functions but delete a BBS from the BBSLIST)
  183. 3 = prefuser (all functions but sysop)
  184. 4 = expuser (unlimited time)
  185. 5 = sysop (can use all functions including sysop functions)
  186.  
  187.  
  188. Secondary access levels are different and can be confusing at times, 
  189. but for your sake I'll type slowly <grin>.  There are 8 secondary
  190. access levels, they are 1,2,4,8,16,32,64,and 128.  These are used to
  191. restrict the sub-boards and filesections to only certain users.  If
  192. a person wants access to a board, you must add the secondary access 
  193. neccesary to get on the board to the user's secondary access level.
  194. For example.  User A has access to the Apple sub (special access of
  195. 4) and he buys an IBM.  He requests access to the IBM sub as well, 
  196. the special access need for IBM is 16.  Since User A's special access
  197. is four and you add 6 to it his special access would have to be 20.
  198. If you don't understand read it carefully again, I've explained as 
  199. much as is possible without repaeting myself.  Sysops automatically
  200. have access to all subs (255). 
  201.  
  202. Getting Your GSBBS up and Running.
  203.  
  204.     After entering the necessary informations for CONFIG.CNF,
  205. TITLES.CNF and FILES.CNF, and creating the file IDS.BBS, you now
  206. can start compiling the system.  Load Turbo PASCAL ver 3.0 (an 
  207. earlier version will not work)  Go to the options menu, select a 
  208. COM file compilation and return to the main menu.  Compile the file
  209. BB1.PAS.  It will create BB1.COM and BB1.000, .001, and .002.  Next
  210. compile all .PAS prgrams EXCEPT BB2.PAS and BB3.PAS as these were 
  211. compiled with BB1 (that's why BB1 was 4074 lines).  Also copy SORT.EXE
  212. from your DOS disk to the main disk.
  213.  
  214.     The suggested way of starting up the BBS is S1.BAT. For some
  215. reason, this file does not work well with me.  Essentially you can
  216. find out what it does by looking at the batch file.  Basically it
  217. cleans up your system.  SORT1.COM is used with SORT.EXE to update
  218. USER.TXT with IDS.BBS as it is not done by the BBS.  MAILCLR and 
  219. COMPMESS are cleanup fles for your message bases and e-mail system.
  220. ERR.COM records to ERRFILE.TXT exactly what the screen looked like
  221. when an error occured.  I have no idea what CONVTIDS does, but 
  222. if you know PASCAL you should look at it.
  223.  
  224. COMMANDS...
  225.     There are two types of commands locally entered ones and
  226. user entered ones.  New mods to the user entered commands are as 
  227. follows...
  228.     [E]nter UserMessage  this requests the user to type a message
  229. and it will display it before the command prompt.  There is only
  230. one problem.  The mod only works like it should 50% of the time.  
  231. What I have done is told the program that if no message has been 
  232. entered by anyone (after the system was just put up) to display, 
  233. "Welcome!"  Some of the time, it displays code for the program.  The
  234. easiest way to avoi a user getting this is by merely logging on when-
  235. ever you put up the system, and double checking it to make sure it is
  236. okay, if not change it and it will be fine.  Call my BBS for in depth
  237. explaination of how it works.
  238.     [A]sk Sysop  This is an incredibly easy and somewhat stupid
  239. mod on my part, but hey(!) who cares?  What it does is tells the user
  240. to leave mail to user 000 and sends him to the mail system, it is good
  241. to teach new users how he mail system works and to tell them that lvl
  242. 1 people can use the mail system. 
  243.  
  244. The following are local commands.  The first three are not mods.
  245.     F1 = Chat.  Breaks in to chat with a user
  246.     Ctrl-C  = Breaks chat. (Gives user control again)
  247.     F10 = force log off of user (no more turkeys!)
  248.  
  249.  
  250. The following are mods.
  251.     F2 (While user online) = online vaildation.  If user has below
  252. access level 2 (primary) then it is raised to two.  If it is above two
  253. then the access level is raised by one. (2 becomes 3 and 3 becomes 4).
  254. Do not use this command with a level 4 or a level 5 user.  The level 
  255. four will be changed to level 5 then he will be reset to level one.  
  256. Level 5 will be raised to level 6, BUT level 6 users have no privilages
  257.  
  258.     F3 (While user online) = Toggles chat on.  
  259.     F4 = Toggles chat off.  This is so when you want to go to bed
  260. early yet your hours are from 7am to 1am (don't worry they are 
  261. currently set to 7am to 10pm)  You can press F4 (enter) and no user
  262. will be able to call you ("Sorry Swabbie but xx's secretary is holding
  263. all calls").  F3 toggles this function off so others can now request
  264. to chat.  
  265.  
  266. These are useable only while the message "Waiting for call" is 
  267. displayed.
  268.  
  269.     F2 = Display Timelog (not usable online)
  270.     F3 = Display Uerlog (not usable online)
  271.     <ESC> = Sign on locally (not usable while online)
  272.  
  273. Notes.
  274.     You will want to change the chat prompts to have your name
  275. rather than mine.  This is done by editing BB2.PAS and somewhere 
  276. between lines 1000 and 1300 are procedures talk and chat.  Either
  277. that or Type ^Q^A (Find) STARGAZER (Replace with) YOURNAME (options)
  278. <enter>  It will ask to replace and you'll be in the general area you
  279. need to fix (if not, hit pg dn once).  Then erase BB1.000, .001, .002
  280. and .COM and recompile BB1.  
  281.  
  282.     Another thing you want to do is to keep GSBBS.ARC onhand in
  283. case of any foul-ups like I once got.  Also erase all .PAS files after
  284. your are done modifying the BBS, that way you have more room for users
  285. and the Caller's log (TIMELOG and USERLOG) etc.   
  286.  
  287.     Lastly I'd like to thank, Mongo Varga, SYSOP of the Ghost Ship
  288. East, as it was with his docs that I am putting up a GSBBS and with his
  289. docs on hand that these docs were able to be written.
  290.  
  291.     Call the Ronin, a Ghost Ship BBS at 203-655-0152 300/1200 baud.
  292.  
  293. StarGazer
  294.  
  295.